home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / palert24.zip / PALERT.DOC < prev    next >
Text File  |  1991-10-22  |  14KB  |  416 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                   P A L E R T
  17.  
  18.                                       by
  19.  
  20.                                   Patri-Soft
  21.  
  22.  
  23.  
  24.                                   Version 2.4
  25.                                   October 1991
  26.  
  27.  
  28.  
  29.  
  30.                        Support BBS --  Patriquin's BBS
  31.                                        714-352-2825 (DATA)
  32.                                        714-352-2820 (Voice)
  33.                                        714-352-1527 (FAX)
  34.  
  35.  
  36.  
  37.                           Copyright 1991 by Patri-Soft
  38.  
  39.  
  40.  
  41.                         Table of Contents
  42.  
  43.  
  44.       What is PALERT. . . . . . . . . . . . . . . . . . . . . .   1
  45.       Features  . . . . . . . . . . . . . . . . . . . . . . . .   2
  46.       Command Mode Parameters . . . . . . . . . . . . . . . . .   3
  47.       Examples  . . . . . . . . . . . . . . . . . . . . . . . .   5
  48.       Registering PALERT. . . . . . . . . . . . . . . . . . . .   7
  49.       Registration Form . . . . . . . . . . . . . . . . . . . .   8
  50.       Problems and Maintenance. . . . . . . . . . . . . . . . .   9
  51.       Other Utilities . . . . . . . . . . . . . . . . . . . . .   9
  52.  
  53.  
  54.  
  55.  
  56.       What is PALERT
  57.       --------------
  58.  
  59.       PALERT is a utility program to help you avoid unexpectedly
  60.       running out of disk space and/or memory.  Many times application
  61.       programs terminate abnormally or disallow you from completing a
  62.       function because of insufficient disk space or memory.
  63.       Sometimes, this may cause you to lose valuable work time and
  64.       sometimes causes data to be lost. PALERT watches your disk space
  65.       and warns you when space is getting low.
  66.  
  67.       PALERT lets you specify your disk space needs and then watches
  68.       the disk until that limit is reached.  It then warns you of
  69.       the situation and lets you take appropriate action.  PALERT
  70.       is implemented as a standard DOS command that may be used
  71.       by itself or from a DOS batch command file.
  72.  
  73.       Implement PALERT before starting any application or program
  74.       where sufficient disk space is critical.  PALERT will save
  75.       you time and money.
  76.  
  77.       Features:
  78.       ─────────
  79.  
  80.         **  Checks disk space whenever you want to.
  81.  
  82.         **  Checks available memory
  83.  
  84.         **  Can let applications know what day is today.
  85.  
  86.         **  Can trigger other commands based on insufficient
  87.             disk space and/or memory
  88.  
  89.         **  Many features to customize messages and actions
  90.  
  91.         **  Easy to install and use
  92.  
  93.                                                                 Page  2
  94.  
  95.       Command Mode Parameters
  96.       -----------------------
  97.  
  98.       PALERT allows several command parameter switches to be specified
  99.       to customize the process.  All these parameters are optional. The
  100.       command format and switch parameters are described below.  A quick
  101.       review of command parameters is always available by entering the
  102.       PALERT command with the /H parameter.
  103.  
  104.       COMMAND FORMAT:
  105.  
  106.       PALERT [drive:]    [ (/ switches) ]
  107.  
  108.  
  109.       [drive:]  If desired you may specify the drive where space is to
  110.                 be checked.  If the drive letter is not specified, the
  111.                 current defualt drive is checked. PALERT will also check
  112.                 multiple drives.  For example: PALERT CDE will check
  113.                 drives C, D, and E and give you a cumulative display.
  114.                 (This also works with all parameters)
  115.  
  116.  
  117.       /Wppp     Warn the user and set DOS ERRORLEVEL flag if the
  118.                 percentage of free disk space is less than the ppp value
  119.                 specified.
  120.  
  121.                 /W5 indicates to warn user if less than 5 percent of
  122.                 disk space is free.
  123.  
  124.  
  125.       /Bbbbb    Warn the user and set DOS ERRORLEVEL flag if the
  126.                 number of kilobytes of free disk space is less than the
  127.                 bbbb value specified.  The maximum value of bbbb is
  128.                 32767.
  129.  
  130.                 /B3000 indicates to warn the user if less than
  131.                 3,000,000 characters of disk free space exist.
  132.  
  133.       /D        Return an errorlevel according to the Day. PALERT will
  134.                 return an errorlevel for the day only when the /D
  135.                 parameter is specified.  The errorleves returned are:
  136.                 0 - Sunday      3 - Wedensday   6 - Saturday
  137.                 1 - Monday      4 - Thursday
  138.                 2 - Tuesday     5 - Friday
  139.  
  140.                 A sample .BAT files is included to demonstrate how to
  141.                 use this capability.
  142.  
  143.       /Lxxx     Warn when available memory is less than xxx. Sets the
  144.                 DOS ERRORLEVEL flag to 2.
  145.  
  146.                 PALERT /L400 will warn you if memory is below
  147.                 400,000 bytes.
  148.                                                                   Page 3
  149.  
  150.  
  151.       /E        SupprEss the disk check and check only memory
  152.  
  153.       /N        A scale that shows used disk space is normally
  154.                 shown to the user each time PALERT is run.  To
  155.                 prevent the scale from being displayed, enter the
  156.                 /N parameter.
  157.  
  158.  
  159.       /M        Messages are normally shown to indicate the Total,
  160.                 Used, and Free disk space.  If these messages are
  161.                 not normally wanted, enter the /M parameter.  Then they
  162.                 will only be issued when the user is warned.
  163.  
  164.  
  165.  
  166.       /P        After the user is warned of insufficient disk/memory
  167.                 space, PALERT will pause to make sure the user is aware
  168.                 of the situation.  To avoid this pause enter /P.
  169.  
  170.  
  171.       /S        When PALERT detects insufficient disk/memory space it
  172.                 sounds an alert to the user.  To avoid this noise
  173.                 specify the /S parameter.
  174.  
  175.  
  176.       /C        Each time PALERT is run it reminds the user that HELP is
  177.                 available by entering the /H parameter.  To avoid this
  178.                 message enter /C.
  179.  
  180.  
  181.       /H        PALERT contains internal help that is available at
  182.                 any time by using the /H parameter.
  183.  
  184.       PALERT automatically checks the system date to determine if it is
  185.       current or not.  If it is not, PALERT allows you to set it
  186.       correctly.
  187.  
  188.                                                                 Page  4
  189.  
  190.  
  191.       Examples:
  192.  
  193.       1.  Warn user when less than 1,000,000 characters of disk
  194.           space is available.
  195.  
  196.               ===> PALERT C: /B1000 /C
  197.  
  198.  
  199.       2.  Warn user when less than 5 percent of disk space is
  200.           available.
  201.  
  202.               ===> PALERT C: /W5 /C
  203.  
  204.  
  205.       3.  Warn user when less than 300K of memory is available:
  206.  
  207.               ===> PALERT /L300
  208.  
  209.  
  210.       4.  DOS batch file that will check disk space each time
  211.           the LOTUS command is entered.  If the desired disk space is
  212.           not available stop the command.
  213.  
  214.             PALERT /b2000/m
  215.             if errorlevel 1 goto error
  216.             LOTUS
  217.             goto end
  218.             :error
  219.             ECHO command terminated due to insufficient disk space
  220.             :end
  221.  
  222.           This sample DOS batch file may be found in the .ARC file
  223.           that contains this program.  Name=PA123.BAT.
  224.  
  225.       5.  Determine the day by using PALERT /D.
  226.  
  227.                 PALERT /D
  228.                 if errorlevel = 2 goto tue
  229.                 etc....
  230.  
  231.           Sample batch file included, called DAY.BAT
  232.  
  233.                                                                 Page  5
  234.  
  235.  
  236.       Registering PALERT
  237.       ──────────────────
  238.  
  239.       PALERT is distributed under the Shareware concept.  This makes it
  240.       available for anyone to try without obligation.  If you decide it
  241.       is useful and want to keep it, I ask that you register your use
  242.       of it.  This will allow for continued support and maintenance of
  243.       the program and will help to encourage that more quality software
  244.       be made available through this channel.   We require all
  245.       corporate and government users of this u